语言项(Lang items)

lang-items.md


commit 893f42a83466cf02b6fd6d3c82d5419cdad47474

注意:语言项通常由 Rust 发行版的 crate 提供,并且它自身有一个不稳定的接口。建议使用官方发布的 crate 而不是定义自己的版本。

rustc编译器有一些可插入的操作,也就是说,功能不是硬编码进语言的,而是在库中实现的,通过一个特殊的标记告诉编译器它存在。这个标记是#[lang="..."]属性并且有不同的值...,也就是不同的“语言项”。

例如,Box指针需要两个语言项,一个用于分配,一个用于释放。下面是一个独立的程序使用Box语法糖进行动态分配,通过mallocfree

  1. #![feature(lang_items, box_syntax, start, libc, core_intrinsics)]
  2. #![no_std]
  3. use core::intrinsics;
  4. extern crate libc;
  5. #[lang = "owned_box"]
  6. pub struct Box<T>(*mut T);
  7. #[lang = "exchange_malloc"]
  8. unsafe fn allocate(size: usize, _align: usize) -> *mut u8 {
  9. let p = libc::malloc(size as libc::size_t) as *mut u8;
  10. // Check if `malloc` failed:
  11. if p as usize == 0 {
  12. intrinsics::abort();
  13. }
  14. p
  15. }
  16. #[lang = "exchange_free"]
  17. unsafe fn deallocate(ptr: *mut u8, _size: usize, _align: usize) {
  18. libc::free(ptr as *mut libc::c_void)
  19. }
  20. #[lang = "box_free"]
  21. unsafe fn box_free<T: ?Sized>(ptr: *mut T) {
  22. deallocate(ptr as *mut u8, ::core::mem::size_of_val(&*ptr), ::core::mem::align_of_val(&*ptr));
  23. }
  24. #[start]
  25. fn main(argc: isize, argv: *const *const u8) -> isize {
  26. let x = box 1;
  27. 0
  28. }
  29. #[lang = "eh_personality"] extern fn rust_eh_personality() {}
  30. #[lang = "panic_fmt"] extern fn rust_begin_panic() -> ! { unsafe { intrinsics::abort() }
  31. # #[lang = "eh_unwind_resume"] extern fn rust_eh_unwind_resume() {}
  32. # #[no_mangle] pub extern fn rust_eh_register_frames () {}
  33. # #[no_mangle] pub extern fn rust_eh_unregister_frames () {}

注意abort的使用:exchange_malloc语言项假设返回一个有效的指针,所以需要在内部进行检查。

其它语言项提供的功能包括:

  • 通过特性重载运算符:==<,解引用(*)和+等运算符对应的特性都有语言项标记;上面4个分别为eqordderefadd
  • 栈展开和一般故障:eh_personalityfailfail_bounds_checks语言项
  • std::marker中用来标明不同类型的特性:sendsynccopy
  • std::marker中的标记类型和变化指示器:covariant_typecontravariant_lifetime

语言项由编译器延时加载;例如,如果你从未用过Box则就没有必要定义exchange_mallocexchange_free的函数。rustc在一个项被需要而无法在当前包装箱或任何依赖中找到时生成一个错误。